home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / management / screenselect_2.1 / docs / screenselect.doc next >
Text File  |  1994-11-17  |  22KB  |  601 lines
  1. ScreenSelect
  2. ************
  3.  
  4.    Version: 2.1 , Release date: 03-Oct-93
  5.  
  6.    Copyright (C) 1992,1993 Markus Aalto (1)
  7.  
  8.    ---------- Footnotes ----------
  9.  
  10.    (1)  This program is freeware. You may freely distribute it as long
  11. as you don't charge more than nominal fee for copying it (max 3 US$)
  12. and no deletions is made to the original package. You may also include
  13. it to freely distributable disks such as Fred Fish collection.
  14.  
  15.    This program is distributed without warranty of any kind. So I take
  16. no responsibility about this program, its documentation, functionality
  17. or damages it may cause.
  18.  
  19. Introduction
  20. ************
  21.  
  22.    In version 2 of Amiga operating system was introduced a concept of
  23. Public Screens. These screens can be shared by application programs
  24. just like Workbench screen has been in previous OS versions. Although
  25. they bring a great addition to Amiga they also introduce a problem to
  26. users which have Workbench, several Public and propably a few custom
  27. screens open at the same time. And the problem is - "How to get that xxx
  28. screen to front quickly without traversing through 5 other screens with
  29. left-amiga m?". Well, ScreenSelect is answer to that question
  30. because it opens a small window to the active screen after hotkey
  31. selection where you can select the new frontmost screen with just a
  32. click of the mouse. Also you can make hotkey bindings to any screens
  33. (not just Public ones as in older versions) and for example get
  34. Workbench screen frontmost with only one key press. And the only
  35. requirement is that you have Kickstart 2.04 (V37) or greater.
  36.  
  37. Installation
  38. ************
  39.  
  40.    I have provided a script for Commodore's Installer program so if
  41. you have it then you should propably use it. Otherwise you can do
  42. following actions.
  43.  
  44.    * Move ScreenSelect to WBStartup directory.
  45.  
  46.    * Move ScreenSelectPrefs to Prefs directory.
  47.  
  48.    * Move one of the doc files anywhere you normally store document
  49.      files.
  50.  
  51. ToolTypes and CLI usage
  52. ***********************
  53.  
  54.        ScreenSelect recognizes normal commodity tooltypes and one of
  55. its own.
  56.  
  57. CX_POPUP
  58.      This switch enables ScreenSelect to open its window when it's
  59.      started.  Default is no popup.
  60.  
  61. CX_PRIORITY=xxx
  62.      This is ScreenSelect's priority as commodity.  Here xxx is
  63.      decimal number. Default is 0.
  64.  
  65. CX_POPKEY=HOTKEY
  66.      Default is shift esc. For example you could use CX_POPKEY=alt
  67.      shift del to change hotkey. If you specify popkey here you
  68.      override the settings you have made with ScreenSelectPrefs
  69.      program.
  70.  
  71. PREFSPROGRAM=PATH
  72.      This is the path where preferences program is to be found. This
  73.      name must include the name of the preferences program. Default
  74.      PATH is SYS:Prefs/ScreenSelectPrefs. see Preferences.
  75.  
  76. Main Window
  77. ***********
  78.  
  79.    You can see the main selection window for ScreenSelect by pressing
  80. the user configurable hotkey. This brings you a small window with few
  81. buttons and a listview with names of open screens. Public screens all
  82. have identifiable names but there are programs which use custom screens
  83. and doesn't specify any name for it. Screens like that are shown as
  84. (Nameless Screen).
  85.  
  86. Quit
  87.      By pressing button (or Q) you can remove ScreenSelect and any
  88.      patches it has installed.
  89.  
  90. About
  91.      This gives you a small info about this program and its author
  92.      (that's me :^).
  93.  
  94. Prefs
  95.      This one opens the separate preferences program you can use to
  96.      modify ScreenSelect's behaviour. All changes come active
  97.      instantly after you have exited preferences program with pressing
  98.      either Save or Use buttons.
  99.  
  100. Update
  101.      This one updates the listview and default pubscreen texts to
  102.      reflect current system state.  This is only usefull if you haven't
  103.      installed Auto Update patches.  You can install the patches with
  104.      ScreenSelectPrefs program.  see Preferences.
  105.  
  106. Listview gadget
  107.      Click any of the names to get that screen to front. Single click
  108.      just activates the name which you can then activate with
  109.      Activate gadget.  Double click makes an instant activation.
  110.      You can also use cursor keys to move up and down in listview.
  111.      Activation can be made from keyboard with a or return keys.
  112.  
  113. Default PubScreen
  114.      This one shows the name of the default pubscreen. If you have
  115.      installed the Change Default PubScreen hotkey you can use it to
  116.      select active public screen as your default public screen.
  117.  
  118. Activate
  119.      Activates the current listview selection and closes the window.
  120.  
  121. Cancel
  122.      Closes the window and returns back to the screen where hotkey
  123.      selection was made.
  124.  
  125. General Info
  126. ************
  127.  
  128.    There are few special options you can change with preferences
  129. program.  Here are brief explanations about them. see Preferences
  130.  
  131. Screen Types
  132.      Currently ScreenSelect can show only Public screens or all
  133.      screens.
  134.  
  135. AutoUpdate Patches
  136.      This patches 4 Intuition functions to achieve automatic update in
  137.      listview and in Default PubScreen textgadget. Patched functions
  138.      are: OpenScreen, OpenScreenTagList, CloseScreen and
  139.      SetDefaultPubScreen.
  140.  
  141. Window Position Modes
  142.      You can control the position of ScreenSelect's main window with
  143.      three possible options: Fixed, Relative and SmartPointer.
  144.  
  145.          Fixed mode forces window to always open to some predefined
  146.      coordinates.
  147.  
  148.          Relative always tries to position the window so that pointer
  149.      is over the Activate gadget.
  150.  
  151.          SmartPointer first tries to position the window so that
  152.      pointer is over the last selected screen name. If this isn't
  153.      possible it then forces pointer to move there.
  154.  
  155. Window Autoactivation
  156.      You can set few options to control ScreenSelect's behaviour with
  157.      window activation.
  158.  
  159.      If you have Window AutoActivation mode ON, it tries to activate
  160.      window from screen you are changing to. It doesn't work most of
  161.      the times because it just examines the windows and tries to be
  162.      smart when deciding which window to activate.
  163.  
  164.      If also InputHandler is ON, then ScreenSelect 'hears' all the
  165.      changes with window actications. This helps you only with changes
  166.      through ScreenSelect. If you change screen with left-amiga
  167.      m ScreenSelect has no way of knowing that you have switched to
  168.      new screen except if you have added LoadView patch.
  169.  
  170.      If LoadView patch is active then ScreenSelect can hear all the
  171.      screen changes and can always change new active window. As this
  172.      one says it installs a patch to LoadView function in
  173.      graphics.library. It's a very time critical place and while I
  174.      haven't confronted any problems, it might be a source of problem
  175.      for users with heavy animation needs. If you encounter any
  176.      problems with animations you should first try to take this off
  177.      before starting to look problems elsewhere.
  178.  
  179.      So lets go all modes through one more time.  Window
  180.      AutoActivation activates autoactivation mode. InputHandler
  181.      option enables ScreenSelect to remember all changes with screens
  182.      active windows and LoadView Patch enables to hear all the
  183.      frontmost screen changes. For best possible operation I suggest
  184.      you to select them all.
  185.  
  186. Preferences
  187. ***********
  188.  
  189. Main Prefs
  190. ==========
  191.  
  192.    After you have started ScreenSelectPrefs you get a window very
  193. similar to the system preferences program. All the actions from menus
  194. and Save, Use and Cancel buttons are exactly the same as in
  195. system programs so they are not explained here. Please consult your
  196. AmigaDOS manual for more info.
  197.  
  198.    However there are two buttons labeled as Options and Hotkeys.  These
  199. are the buttons